home *** CD-ROM | disk | FTP | other *** search
/ Hardcore Gamer Resource Kit / Hardcore Gamer Resource Kit - Disc 2.iso / Pc / A_C / BARIS101.ZIP / ULTRAMID / README < prev    next >
Text File  |  1993-09-15  |  30KB  |  651 lines
  1.  
  2.                                            A d v a n c e d
  3.                    ▄▄▄▄  ▄▄▄▄▄    ▄▄▄▄  ▄▄    ▄▄ ▄  ▄▄▄▄▄
  4.                   ▐  ▄▄  ▐    ▌  ▐█  █▌ ▐█    █▌ █ ▐▄▄▄▄▄
  5.                   ▐    ▌ ▐▀▀█▀  ▐█    █▌ ▐█  █▌  █       ▌
  6.                    ▀▀▀▀  ▀   ▀  ▀      ▀  ▀▀▀▀   ▀  ▀▀▀▀▀
  7.                   Advanced Gravis Computer Technology Ltd.
  8. 
  9.       Fax (604) 431-5155                   BBS  (604) 431-5927 V32bis
  10.       Compuserve: GO PCVENB (71333,350)    InterNET EMail: tech@gravis.com
  11.       FidoNET: 1:153/978                   SBCNET: 13:900/3
  12.  
  13.                    UltraMID TSR V1.03 (UMID103.ZIP)
  14.  
  15.                        1.0 About these Drivers
  16.                        2.0 Installation
  17.                        3.0 Who Supports
  18.                        4.0 Revision history and Packing List
  19.                        5.0 Troubleshooting
  20.                        6.0 Note for Developers
  21.  
  22. 1.0.0 *************** CHAPTER 1. - ABOUT THESE DRIVERS *******************
  23.  
  24. 1.1.0 What is UltraMID
  25.        ================
  26.  
  27.  The Advanced Gravis UltraSound card is a unique sound card in the
  28.  sound card industry.  It is the only audio product for the PC that can
  29.  produce realistic sounding instruments without requiring an expensive
  30.  digital signal processor.  Digital signal processors (DSPs) are
  31.  relatively expensive microprocessors that are designed specifically
  32.  for working with audio and visual data.  UltraMID is a software version
  33.  of a DSP.  It provides an extremely easy way for software developers to
  34.  write software for the UltraSound card.
  35.  
  36. 1.2.0 What does UltraMID do for me
  37.        ============================
  38.  
  39.  Most of the new games that are released that support the UltraSound
  40.  card will use UltraMID for midi music and digital synthesis.  There
  41.  are titles being released from almost 100% of the major game comapanies
  42.  that use UltraMID.  Each of these games will ship with its own version
  43.  of UltraMID.  However many games that are already out on the market
  44.  can be adapted to use UltraMID.  Any games that uses the "Audio Interface
  45.  Libraries" from Miles Design, Inc., (AIL), or DIGPAK from The Audio
  46.  Solution, can use UltraMID.  AIL and DIGPAK drivers have been included
  47.  with UltraMID so that you can get older software to work with the
  48.  UltraSound card.
  49.  
  50. 1.3.0 Audio Interface Libraries (AIL) - MIDPAK/DIGPAK
  51.        ===============================================
  52.  
  53.  The Audio Interface Libraries (AIL), (we know them as "Miles" Drivers)
  54.  and DIGPAK are a set of interface drivers which enable software
  55.  developers (mainly game developers) to integrate sound capabilities
  56.  into their programs.  Once a developer has integrated his program into
  57.  the AIL drivers the application will work with all sound cards on the
  58.  market who provide AIL drivers. The AIL's provide support for MIDI as
  59.  well as the Digital Sound interface of an audio card. These library
  60.  drivers allow the developers to use UltraSound's wavetable synthesizer
  61.  and allow them to utilize the UltraSound's digital interface to play 8
  62.  or 16 bit audio in either mono or stereo mode.
  63.  
  64.  Advanced Gravis & FORTE have recently designed and released to Miles
  65.  Design and The Audio Solution Inc. the AIL and DIGPAK routines for the
  66.  UltraSound card which provide the mechanism for developers to easily
  67.  integrate with, and use UltraSound's features.  Developers who have
  68.  the AIL's and/or DIGPAK can get the driver updates and integrate
  69.  their programs into the UltraSound.  The AIL/DIGPAK updates will also
  70.  be available through the Advanced Gravis BBS or any of our nodes.  
  71.  Please refer to GRAVNODE.TXT for a complete list. Developers who do
  72.  not have the AILs can get them from Miles Design and/or DIGPAK from
  73.  The Audio Solution Inc.
  74.  
  75.  Developers who want to take full advantage of UltraSound's advanced
  76.  features; and do not want to pay either Miles Design or The Audio
  77.  Solution Inc. license fees, Advanced Gravis and FORTE have a stand
  78.  alone driver as well.  These drivers use a Terminate and Stay
  79.  Resident (TSR) utility called UltraMID.  Developers utilizing this
  80.  TSR are able to do digital playback at 8 or 16 bits up to 44.1kHz
  81.  sample rate.  Also, this allows programmers to use all of the
  82.  UltraSound's 32 digital voices as well as the superior wavetable
  83.  synthesizer.
  84.  
  85.  These drivers are another level of support for the UltraSound card
  86.  developers.  Both the AIL and DIGPAK interfaces provide a means
  87.  for programmers to easily design software for many sound cards using
  88.  only one API while Advanced Gravis/FORTE's stand alone TSR allows
  89.  developers to take advantage of UltraSound's more advanced features.
  90.  
  91.       ....................... END of Chapter 1 ...........................
  92.  
  93. 2.0.0 ****************** CHAPTER 2. - INSTALLATION ***********************
  94.  
  95.  If you are reading this you have probably already unzipped
  96.  all the files into a directory.  Once this is done type "UMINSTALL".
  97.  This program will copy ULTRAMID.INI to your ULTRASND\MIDI directory,
  98.  and ULTRAMID.EXE to your ULTRASND directory.  It does this by
  99.  looking for your ULTRADIR environment variable.  It will also verify
  100.  all of your patches to make sure that they are compatible with UltraMID.
  101.  
  102.  Once the install is completed, you can start ultramid by simply
  103.  typing "ultramid" at the DOS prompt.
  104.  
  105. 2.0.1 installing the AIL, or DIGPAK drivers.
  106.  
  107.  If you have a game that uses the AIL or DIGPAK drivers and you
  108.  would like to get that game to use UltraMID, read this section.
  109.  
  110.  Now for the tough part. First, find a game that uses the AIL or
  111.  DIGPAK/MIDPAK drivers.  A partial list is provided at the end of
  112.  this README.  To determine if a game uses the AIL drivers look for
  113.  files that end with ".ADV".
  114.  
  115.  FIRST, you should make a backup of the games current .ADV drivers,
  116.  just in case something happens.  What we will now do is overwrite 
  117.  some of these files with the Gravis drivers.  
  118.  
  119.  A table is provided below with some guidelines on which files you
  120.  should overwrite:
  121.  
  122.          COPY FROM      COPY TO      CONFIGURE THE GAME AS
  123.          =================================================
  124.          GF1MIDI.ADV    MT32MPU.ADV  Roland
  125.          GF1DIGI.ADV    SBDIG.ADV    Sound Blaster
  126.              OR
  127.          GF1MIDI.ADV    SBFM.ADV     Sound Blaster
  128.          GF1DIGI.ADV    SBDIG.ADV
  129.              OR
  130.          GF1MIDI.ADV    MT32MPU.ADV  Roland
  131.          GF166.COM      SBLASTER.COM Sound Blaster (DIGPAK)
  132.  
  133.  By looking at the names and size of the .ADV drivers you should be able
  134.  to determine which cards they are for.  For example:
  135.  
  136.     ADLIB    ADV     14693 07-07-92   6:00a  = Adlib
  137.     ADLIBG   ADV     16175 07-07-92   6:00a  = Adlib Gold
  138.     ARIAXMID ADV     44836 03-26-93  10:26a  = Aria
  139.     MT32MPU  ADV     10590 03-16-92  12:00p  = Roland
  140.     MULTISND ADV      7042 03-09-93  12:51p  = Turtle Beach
  141.     PASFM    ADV     15160 07-07-92   6:00a  = Pro Audio Spectrum
  142.     PCSPKR   ADV      8306 03-16-92  12:00p  = PC Speaker
  143.     SBFM     ADV     14743 07-07-92   6:00a  = Sound Blaster
  144.     SBP1FM   ADV     15153 07-07-92   6:00a  = Sound Blaster Pro
  145.     GF1DIGI  ADV      5248 08-14-93   3:49p  = UltraSound Digital
  146.     GF1MIDI  ADV     10816 08-14-93   3:50p  = UltraSound MIDI
  147.  
  148.  In general if any .ADV file is > 10K it is the music driver and should
  149.  be copied over with GF1MIDI.ADV.  If any .ADV file is < 10K it is the
  150.  digital audio driver and should be replaced with GF1DIGI.ADV
  151.  
  152.  Once this is done simply run the games setup and select whatever
  153.  sound card that you just over wrote with the Gravis drivers.
  154.  For example, if you copied over top of the Sound Blaster and Roland
  155.  drivers then you would configure the game for sound blaster roland.
  156.  
  157.  That is it.  If everything is working correctly you should now be
  158.  getting UltraSound support in that game.  If not please refer
  159.  to the trouble shooting section in chapter 5.
  160.  
  161.  
  162. 2.1.0 Hints and Tricks
  163.        ================
  164.  
  165.  - In theory you could copy over top of ANY of the .ADV drivers as
  166.    long as you know which sound card to configure the game for.
  167.  
  168.  - Some programs do not use the regular naming convention for .ADV
  169.    drivers, for instance Ultima Underworld II by Origin.  The
  170.    convention for UW2 is DM*.ADV, and DD*.ADV.  The DM is for
  171.    MIDI and the DD is for digital audio.  Since we can't tell by
  172.    looking at the file name which sound card these drivers are for
  173.    you may just want to copy GF1DIGI.ADV overtop of ALL DD*.ADV
  174.    files and GF1MIDI.ADV overtop of all DM*.ADV drivers.
  175.  
  176.   REMEMBER TO BACKUP YOUR ORIGINAL .ADV DRIVERS
  177.  
  178.  - In theory, a game should be looking in its sound driver directory
  179.    for any files with a .ADV extention, then present the user with a
  180.    list of the sound card drivers found.  For instance, in Spell
  181.    Caster 2000 you simply have to copy the GF1*.ADV drivers into
  182.    its directory.  It will then detect these drivers and you may choose
  183.    ULTRASOUND from its setup menu. This is the only game so far that
  184.    I've been able to find which does this.
  185.  
  186.  - (06/22) Origin uses a slightly modified version of the AIL drivers.
  187.    As such their games may sound slightly off or not work at all with
  188.    our drivers. An example of this is Strike Commander, which will not
  189.    work at all with the standard AIL interface.
  190.  
  191.  - We have found some games that use both the AIL drivers and access the
  192.    sound hardware directly.  An example of this type of game is EYE OF
  193.    THE BEHOLDER.  Since these type of games do not rely soly on the AIL
  194.    drivers and try to access the hardeware directly they may not work
  195.    with these drivers.
  196.  
  197.  
  198. 2.2.0 Command Line Switchs
  199.        ====================
  200.  
  201.  ULTRAMID by default will try to preload patches for all MIDI songs.
  202.  This will give you the best quality sound but may not be compatible
  203.  with all games.  If you start ULTRAMID but can't get the game to
  204.  make any music, try reloading ULTRAMID with the -C parameter.
  205.  
  206.  e.g. lh ultramid -c -m100 -nultramid.ini -dc:\game\
  207.  
  208.  The above example will load UltraMID high, preload a patch library, sets
  209.  the master volume at 100, looks for an .INI file named Ultramid.ini and
  210.  tells UltraMID to look in the C:\game directory for the configuration
  211.  file.
  212.  
  213.  -C    - Preloads a 256K, 512K 768K or 1024K patch library, depending
  214.      on how much memory you have on your UltraSound card. UltraMID 
  215.      automatically detects how much memory is on your card.  This
  216.      option does not sound as good as patch cacheing but should
  217.      work with all games.
  218.  -F    - Unload ULTRAMID from memory
  219.  -Mxxx - [1-127] Sets the master volume for music.  In some games the
  220.      music may over power the speech.  If so you can use this
  221.      switch to adjust the master volume as required. The default
  222.      volume is 127.
  223.  -Nfilename
  224.        - Tell UltraMID not to use ultramid.ini, but look for an
  225.      initialization file named "filename"
  226.  -Dpath
  227.        - Use an alternate path for finding the ultramid configuration
  228.      file and for finding patches. The path should include a
  229.      trailing backslash (e.g.) -Dc:\game\
  230.  -q    - quiet.  Don't display any messages.
  231.  
  232.  
  233. 2.3.0 Limitations of AIL and DIGPAK
  234.        =======================
  235.  
  236.  The Audio Interface Libraries and DIGPAK each only give access to
  237.  ONE STEREO digital channel.  Since the UltraSound is capable of 32
  238.  independent digital channels this poses quite a limitation.  The
  239.  file UMDOC.ZIP on the Advanced Gravis BBS has detailed technical
  240.  documentation on how to write programs that use UltraMID.  UltraMID will
  241.  let you play multiple simultaneous digital audio tracks as well as
  242.  general midi music.
  243.  
  244.  
  245. 2.4.0 Support
  246.        =======
  247.  
  248.  These AIL, MIDPAK/DIGPAK drivers are intended for developers who
  249.  will be releasing future programs that use the AIL drivers.  We
  250.  are releasing these to the general public so that you may attempt
  251.  to patch older games to include direct UltraSound support.
  252.  
  253.  Since this is our first public release of these drivers we have
  254.  provided a file called FEEDBACK.TXT, which you may fill out and send
  255.  back to us with your comments.  For example, how did you get it to
  256.  work with game 'XYZ'.  Tips you may have for others, etc...
  257.  
  258.  
  259. 2.6.0 General Information
  260.        ===================
  261.  
  262.  - We currently support V3.2 of the DIGPAK standard.
  263.  
  264.  - We currently support V2.0 of the AIL standard.
  265.  
  266.  - You may have heard the names 'John Miles' and 'John Ratcliff' and
  267.    wondered who they are.  John Miles is Miles Design, the designer and
  268.    creator of the Audio Interface Libraries.  John Ratcliff is The
  269.    Audio Solution (MIDPAK/DIGPAK). They are two seperate companies who
  270.    work together towards the same goal.  A standard interface for
  271.    sound cards.
  272.  
  273.  - Documentation on how to program directly for ULTRAMID will be made
  274.    available in the future by Forte and Advanced Gravis.
  275.  
  276.  - If you are interested in AIL or MIDPAK/DIGPAK you may contact Audio
  277.    Solutions at any of the numbers provided later on in this README.
  278.  
  279.  - ULTRAMID will look for your ULTRADIR environment variable to locate
  280.    your MIDI directory.  ULTRAMID.INI must reside in your MIDI directory.
  281.  
  282.  - Tech NOTE: Developers: Please use a multiple of 32 bytes for sound
  283.    buffers.  The Gravis UltraSound card can only DMA to 32 byte
  284.    boundaries; so to reduce UltraMID overhead, a multiple of
  285.    32 bytes will mean no polled I/O.
  286.  
  287.  - (06/22) Sierra and Lucas do NOT use either the AIL drivers or DIGPAK.
  288.    Sierra has drivers available for their general midi games that use
  289.    UltraMID.
  290.  
  291.  - (06/22) If possible try copying overtop of the SCC1 or general midi
  292.    drivers.  As some games will load up a different (usually better)
  293.    music score.  An example of this is the 7th Guest.
  294.  
  295.  
  296.       ....................... END of Chapter 2 ...........................
  297.  
  298. 3.0.0 ****************** CHAPTER 3. - WHO SUPPORTS ***********************
  299.  
  300. 3.1.0 The Audio Solution
  301.        ==================
  302.  
  303.  The following is a list obtained from the Audio Solution BBS
  304.  (PRODUCTS.LST). It is a little out of date but does include some
  305.  information on which game publishers are licensed to use
  306.  these drivers.
  307.  
  308.              THE AUDIO SOLUTION
  309.              P.O. Box 11688
  310.              Clayton, MO 63104
  311.  
  312.      Order/Information: (314)-567-0267 9am-5pm Central Mon-Fri
  313.      Technical Support: (314)-926-0232 9am-5pm Central Mon-Fri
  314.      BBS:               (314)-939-0200 24 hours 7 days.
  315.  
  316.  
  317.              MILES DESIGN, INC.
  318.              6702 Cat Creek Trail
  319.              Austin, TX, 78731
  320.      (512) 345-2642 / FAX (512) 338-9630 / BBS (512) 454-9990
  321.  
  322.  
  323.          DIGPAK/MIDPAK COMPLETE PRODUCT LIST
  324.                (as of 1/3/93)
  325.  
  326.      This list does not reflect all products produced by product line
  327.      licensees; since we are not always informed of those products as
  328.      they are released.  It also does not reflect the products in
  329.      development (over 100) which use either DigPak and MidPak.
  330.  
  331. Product Name            Publisher                    Use
  332. ===========================================================================
  333. <unamed>                Epyx                         DigPak+MidPak
  334. ATC/Tracon              Wesson International         DigPak
  335. Animal Quest            Alive Software               DigPak+MidPak
  336. Battle Chess 4000       Interplay                    DigPak
  337. Battle Cruiser 3000AD   Three-Sixty Pacific          DigPak
  338. Beyond Shadowgate       ICOM Simulations             DigPak+MidPak
  339. Bilou                   Concepteva                   DigPak
  340. BodyLink                Stragem                      DigPak
  341. Chess Maniac 5,000,001  Spectrum Holobyte            DigPak+AIL
  342. Chessmaster 3000        The Software Toolworks       DigPak
  343. Contraption ZAck        Presage Software Co. Inc.    DigPak+MidPak
  344. Creepers                Destiny Software             DigPak+MidPak
  345. Cribbage Master         Ninga                        DigPak
  346. Cyberstrike             Simutronics                  DigPak
  347. DNA Parrot              T&t Research                 DigPak
  348. Dinosaur Adventure      Knowledge Adventure          DigPak
  349. Fun Univ Ntwk Intfc     Fun Univ Netwk               DigPak+MidPak
  350. Gateway to the Savage   Strategic Simulations Inc.   DigPak
  351. Gateworld Trilogy       Home Brew Software           MidPak
  352. GemStone III            Simutronics                  DigPak
  353. Grandmaster Chess       IntraCorp                    DigPak+MidPak
  354. Guardians of Eden       Access Software              MidPak
  355. Guzzle Puzzles          Redwood Games                DigPak
  356. Inspector Gadget:       Azeroth Publishing           DigPak+MidPak
  357. KidDesk                 Edmark Corporation           DigPak
  358. Layout for DOS          Objects, Inc                 DigPak+MidPak
  359. Le Ponctueur            C.R.A.P.O., Inc.             DigPak
  360. Magic Crayon            Alive Software               DigPak+MidPak
  361. Marvin The Moose        Milliken Publishing          DigPak
  362. Math Sequences          Milliken Publishing          DigPak
  363. Math Zone               Milliken Publishing          DigPak
  364. Mechwarrior II          Activision                   DigPak
  365. MicroLeague Baseball IV Microleague Sports Assoc.    DigPak+MidPak
  366. MicroLeague Football II Microleauge Sports Assoc.    DigPak+MidPak
  367. Microleage Cards        Microleage Sports Assoc.     DigPak
  368. Millie's Math House     Edmark Corpoartion           DigPak
  369. Milliken Storyteller    Milliken Publishing          DigPak
  370. Monopoly Deluxe         Virgin Games                 DigPak+MidPak
  371. Mutanoid Math Challenge Legacy Software              DigPak+MidPak
  372. Mutanoid Word Challenge Legacy Software              DigPak+MidPak
  373. My Paint                Saddleback Graphics          DigPak
  374. Oregon Trail Deluxe     MECC                         DigPak+MidPak
  375. Pickle Wars             Redwood Games                DigPak+MidPak
  376. Places to Play          Magnetic Images              DigPak
  377. Pools of Darkness       Strategic Simulations Inc.   DigPak
  378. Ragarok (Valhalla)      Norsehelm Productions        DigPak
  379. Realms of Avarton       Kram                         DigPak
  380. Return to Zork          Activision                   DigPak
  381. Shadow President        DC True                      DigPak
  382. Sights & Sounds         Macmillan/McGraw Hill        DigPak
  383. Solitaire's Journey     Quantum Quality Productions  DigPak+MidPak
  384. Space Adventure         Knowledge Adventure          DigPak
  385. Space Chase 1,2,3       Safari Software              MidPak
  386. Spaceward Ho PC         Presage Software Co. Inc.    DigPak+MidPak
  387. Stepping Stones Bonus   Compu-Teach, Inc.            DigPak+MidPak
  388. Stickybear Townbuilder  Optimum Resource             DigPak
  389. Switch Progressions     Cooper, R.J. & Assoc.        DigPak+MidPak
  390. Switch Quik             Cooper, R.J. & Assoc.        DigPak+MidPak
  391. T-Zero                  Dennis Cunningham            DigPak+MidPak
  392. Terminator 2029         Bethesda Softworks           DigPak
  393. The 7th Guest           Virgin/Trilobyte             DigPak+AIL
  394. Tom Landry Football     Merit Software               DigPak+MidPak
  395. VGA Jigsaw              Alive Software               DigPak+MidPak
  396. Waterford Mental Math   Waterford Institute          DigPak+MidPak
  397. Wheel of Fortune        Gametek                      DigPak+MidPak
  398. WorldAtlas              The Software Toolworks       DigPak+MidPak
  399.  
  400. Product line licensees of DigPak and/or MidPak.  Product line licensees
  401. have the rights to include DigPak and MidPak in any product produced by
  402. their company.
  403.  
  404.           Electronic Arts
  405.           Activision
  406.           Spectrum Holobyte
  407.           The Software Toolworks
  408.           SSI, Strategic Simulations Inc.
  409.           Milliken Publishing Company
  410.           Commodore Computer
  411.           Virgin Games
  412.           Compu-Teach
  413.           Knowledge Adventure
  414.           Gametek
  415.  
  416. Product line licensees to AIL (Mile Design's Audio Interface Library) which
  417. uses the same MIDI drivers as MIDPAK.
  418.  
  419.           Activision
  420.           Strategic Simulations
  421.           Electronic Arts
  422.           Origin Systems
  423.           Spectrum Holobyte
  424.           Virgin-Games
  425.           Knowledge Adventure
  426.           Bethesda Softworks
  427.           Interplay
  428.           Microprose
  429.           Gametek
  430.           Impressions
  431.           Mindscape UK
  432.  
  433.  
  434. 3.2.0 Other Products Found to use these Drivers
  435.        =========================================
  436.  
  437.   Great Naval Battles
  438.   Tony La Rusa Baseball II
  439.   War of Two Worlds
  440.   Spell Caster 2000
  441.   Trump Castle III
  442.   Buzz Aldrin's Race To Space
  443.   Clash of Steel - World War II Europe 1939-45
  444.   SimCity Classic
  445.   SimFarm
  446.   Dark Sun
  447.   Kids Zoo
  448.   SSN Sea Wolf
  449.  
  450.       ....................... END of Chapter 3 ...........................
  451.  
  452. 4.0.0 *************** CHAPTER 4. - ABOUT THIS UPDATE *******************
  453.  
  454. 4.1.0 Revision History
  455.        ================
  456.  
  457.  V1.03  - (09/15/93) MIDI in support for sequencers added
  458.  V1.02a  - (09/02/93) Digital Audio improved
  459.  V1.02  - (09/01/93) All notes off midi message fixed
  460.  V1.01  - (08/31/93) This UltraMID offers much faster patch loading than
  461.              the previous version, and is about 3K smaller.
  462.              It also can load almost twice as many patches as
  463.              it used to in the same amount of PC memory.  (You
  464.              are still bound by the size of your UltraSound card
  465.              however.)
  466.  
  467.              This release also fixes several small bugs.
  468.              1) DMA bug while loading patches.
  469.              2) ULTRAMID.INI problems.
  470.              3) Noises during patch loading.
  471.  
  472.              New Features:
  473.              1) Automatically removes SBOS.
  474.              2) Can split up its code and data so that if you
  475.                 have fragmented upper memory or not enough
  476.                 upper memory, UltraMID can still load a
  477.                 portion of itself high.
  478.  
  479.              PS: REMEMBER TO RUN the UMINSTAL.EXE program.
  480.  V1.0   - (06/25/93) Yes, a version 1.0 release
  481.  V0.97B - (06/22/93) Fifth Beta - Fixed DMA bug.
  482.               Fixed patch loading bug.
  483.               Fixed xmidi multi-sequence bug.
  484.               Fixed digital hang bug.
  485.               Fixed problem with 512K patch library
  486.  V0.96B - (06/17/93) Fourth Beta - Fix DIGPAK buffering
  487.  
  488. 4.2.0 Packing List
  489.        ============
  490.  
  491.  ULTRAMID.EXE     AIL TSR - Required for drivers
  492.  GF1MIDI.ADV      UltraSound MIDI AIL Driver
  493.  GF1DIGI.ADV      UltraSound Digital Audio AIL Driver
  494.  GF166.COM        UltraSound DIGPAK Driver
  495.  UM200.INI        Patch Map for 2.00 - 2.05 UltraSound software releases
  496.  UM206.INI        Patch Map for 2.06 UltraSound software releases
  497.  UM206a.INI       Patch Map for 2.06 UltraSound software releases
  498.  
  499.  README           This README file
  500.  GV.EXE           Gravis Document Viewer
  501.  INSTAL.EXE       Installs the correct .INI file and UltraMID.EXE in your
  502.           ULTRASND directory.
  503.  FEEDBACK.TXT     Beta Test Feedback Form
  504.  GRAVNODE.TXT     List of Gravis BBS Nodes
  505.  SDKORDER.TXT     Gravis SDK Order form
  506.  PUPDATE.EXE      Used to fix .PAT files if necessary. READ Troubleshooting
  507.  DEVELOPR.TXT     Note to Developers
  508.  
  509.       ....................... END of Chapter 4 ...........................
  510.  
  511. 5.0.0 *************** CHAPTER 5. - TROUBLESHOOTING ***********************
  512.  
  513.  I copied the drivers on top of other drivers, but now the game says that
  514.  it can't find the sound card:
  515.  
  516.      1) Most games require running a set-up program to tell it that you
  517.     have changed sound cards.  Try finding such a program and running
  518.     it.  It most likely will not show Gravis or Ultrasound in the list
  519.     of available drivers, so you will have to pick the sound cards which
  520.     you copied the AIL or DIGPAK drivers to.
  521.      2) Some games use modified AIL or DIGPAK drivers.  Most of the games
  522.     from Origin have been modified and therefore are not compatible with
  523.     these drivers.
  524.      3) Some games only use the AIL or DIGPAK drivers for certain
  525.     operations. For the rest of them operations it may try to access
  526.     the sound hardware directly.  These type of games will not work
  527.     with UltraMID and our AIL/DIGPAK drivers.
  528.  
  529.  I have sucuessfully installed the drivers for a game, but sometimes the
  530.  music seems strange, as if its missing notes, or completely quiet:
  531.  
  532.      1) Restart UltraMID with the -c option to preload instruments.  Most
  533.     music will take more than 256K of memory. 768K to 1Mb is the
  534.     optimal setup for the UltraSound card. (.e.g.)
  535.         C> ultramid -f
  536.         C> lh ultramid -c
  537.      2) If you have replaced any of your patches with non-Gravis patches,
  538.     the size may be different. The patch sets in ULTRAMID.INI are
  539.     configured so that your UltraSound card will be loaded with as
  540.     many patches as will fit into its available memory. Leaving 8K
  541.     for digital audio.  This means, if you try and load a patch
  542.     that is 4K bigger than the original, than there will only be a
  543.     4K buffer left instead of an 8K, and the drivers may not be
  544.     able to load correctly.
  545.      3) Your patches may be out of date.  A program called pupdate.exe is
  546.     available which will repair old or bad patches.  doo.pat is an
  547.     example.  run pudate like this:
  548.  
  549.        pupdate -check_patch -force_update *.pat
  550.  
  551.     in your ultrasnd\midi directory.  Pupdate will show you incorrect
  552.     patches and ask if it should update them.  Answer yes to all of
  553.     your patches EXCEPT BLANK.PAT.  BLANK.PAT is meant to be silent
  554.     and should not be corrected.  Pupdate will also create backups of
  555.     all of your patches as it modifies them.  acpiano.pat will become
  556.     acpiano.pa1.  acpiano.pa1 will become acpiano.pa2, etc.  The
  557.     install program uminstal.exe will check all of your patches during
  558.     the install.
  559.     
  560.  Playback of digital audio sounds choppy.
  561.      1) Your disk or CD may be too slow, and the sound card plays sound faster
  562.     then your disk can retrieve data.
  563.      2) The UltraSound cannot play interleaved stereo data, and must use
  564.     your pc to seperate the left and right channel data before playback.
  565.     Slower 286 or 386 machines may not be able to keep up with high
  566.     speed, high fidelity audio.
  567.      3) The game is using audio buffers which are too small for
  568.     the UltraSound to effectively "double buffer" the data.  The
  569.     technique called "double buffering" provides clear sound without
  570.     clicks or pauses in audio, and smooth animations in video.
  571.     Optimal data sizes for UltraMID are multiples of 2K for stereo
  572.     data and multiples of 4K for mono data.  Some audio cards that
  573.     uses the DMA hardware for playback may call this technique
  574.     backfill DMA.  The UltraSound only uses the DMA hardware for data
  575.     transfers; the GF1 actually produces the sound.
  576.  
  577.  When I run ULTRAMID I get a 'error loading patch' message.
  578.      1) You must be running the patches that came with the V2.x software.
  579.     This includes V2.0, V2.2, V2.4, V2.5 and the latest V2.6 disk sets.
  580.      2) A patch may either be missing or corrupt. If you are unable to
  581.     determine which one simply reinstall the patches.
  582.  
  583.  The games says that it can't run because there is not enough memory.
  584.      1) If you are using an Expanded Memory Manager (emm386, qemm, bluemax,
  585.     386max, etc) you can load the driver into high memory to provide
  586.     more conventional memory for your game.  If you Expanded Memory
  587.     manager supports the dos LH command, make sure the following
  588.     line is in your config.sys:
  589.         DOS=HIGH,UMB
  590.     If you are using DOS 5 or DOS 6, you can use the LH command to
  591.     load UltraMID into high memory.  For example: LH ultramid -m100 -c
  592.     will load ultramid into high memory, set the master volume to
  593.     100 (out of 127), and preload as many patches as will fit into
  594.     your UltraSound card. NOTE: 386MAX uses its own command to
  595.     load programs into upper memory instead of LH.
  596.      2) If you cannot use an Expanded Memory Manager but can use an
  597.     extended memory manager (himem.sys), then also include the
  598.     DOS=HIGH,UMB line in your config.sys so that DOS will be loaded
  599.     into upper memory.
  600.      3) If you can't fit UltraMID into high memory, try loading other
  601.     drivers or TSR's into high memory using DEVICEHIGH= instead
  602.     of DEVICE= in your config.sys and LH in your autoexec.bat files.
  603.      4) DOS 6 comes with a utility called MEMMAKER that will help you
  604.     optimize the use of memory on your machine.  QEMM comes with
  605.     a utility called optimize to help you optimize your memory.
  606.     BLUEMAX and 386MAX also have programs to help you maximize
  607.     the use of expanded and extended memory.
  608.      5) If there are other drivers in your system that you don't need
  609.     to play the game, try making a floppy disk with just the programs
  610.     you need to get your machine running.  For example,
  611.          FORMAT /s a:
  612.     will format a disk in the "A" drive and copy MS-DOS to it.  Then
  613.     create a minimal config.sys and autoexec.bat such as:
  614.  
  615.     CONFIG.SYS:
  616.      DEVICE=C:\DOS\HIMEM.SYS
  617.      DEVICE=C:\DOS\EMM386.exe ram
  618.      DOS=HIGH,UMB
  619.      SHELL=C:\DOS\COMMAND.COM C:\DOS\ /E:768 /p
  620.      files=20
  621.      buffers=20
  622.      LASTDRIVE = D
  623.  
  624.     AUTOEXEC.BAT:
  625.      PATH C:\DOS;C:\ULTRASND;C:\UTILS
  626.      SET ULTRASND=220,1,1,11,7
  627.      SET ULTRADIR=C:\ULTRASND
  628.      SET BLASTER=A220 I7 D1 T1
  629.      LH C:\UTILS\MOUSE
  630.      LH ULTRAMID -m100
  631.      rem if you have the memory available, and you are not using
  632.      rem the -c option, Smart Drive improves the performance
  633.      rem for loading patches tremendously.  I have  8Mb on my
  634.      rem machine, so I usually set up a 4Mb disk cache.
  635.      LH C:\DOS\smartdrv /Q 4096 0 c
  636.  
  637.     These examples are for experienced DOS users, and probably won't
  638.     work with your machine without some modification.  Please consult
  639.     your DOS manual or a book that covers memory management to get more
  640.     hints on how to manage PC memory.
  641.  
  642.      6) If you can't get UltraMID to load into high memory and you
  643.     don't need an EMS memory, then load emm386 with the option noems.
  644.     This will give you 64K more room for UltraMID to load.
  645.  
  646.       ....................... END of Chapter 5 ...........................
  647.  
  648.  
  649.                                   THE END
  650.  
  651.